gh-142349: Document LazyImportType.resolve() method - #156936

Documentation build overview

📚 cpython-previews | 🛠️ Build #34491218 | 📁 Comparing dcd84d0 against main (7d71b3e)

  🔍 Preview build  

And https://docs.python.org/3.16/library/types.html#types.LazyImportType doesn't know about https://docs.python.org/3.16/reference/simple_stmts.html#lazy. These guys should talk to each other.

Actually, this belongs to built-in types. Generator (that isn't a builtin name) interface is documented there too.

@Viicos can we move this to built-in types?

I think documenting this in types.rst makes more sense; MappingProxyType is also documented there with some methods.

I indeed took MappingProxyType as a precedent when documenting the method. However, it is the only one currently doing so. Maybe we should move the method definitions of MappingProxyType to https://docs.python.org/3/library/stdtypes.html, and ensure this is done for other types (such as lazy imports) in the future? As mentioned, this is already the case for generator-iterators, which has types.GeneratorType without any method documented.

I also know the stdlib page is huge and there are plans to split it, so not sure what should be done today.

@encukou, what would you recommend?

The full spec should move to the docs. But that's not for this PR to solve.

I worked on this a while ago!